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As many of you may know SRI is part of a team working on the National 
Software Works project. In the course of our work we have developed a 
Procedure Call Protocol to be used between the modules which make up 

the NSW. We are interested in your comments on this protocol. Please 

foreward your remarks to either: 


James E. White (WHITE@SRI-ARC) or Jon Postel (POSTEL@SRI-ARC) 


Augmentation Research Center 
Stanford Research Institute 
Menlo Park, California 94025 


(415) 326-6200 x2960 (White) or x3718 (Postel) 


This note announces the release of the second published version of 
several National Software Works (NSW) and Procedure Call Protocol 
(PCP) documents. Version 2 is SUBSTANTIALLY different than Version 1; 
it and all intermediate, informally distributed PCP documents are 
obsoleted by this release. 


Each of the following documents is available on-line in two forms: as 
an NLS file and as a formatted text file. The Journal number (e.g. 
24459) refers to the former, of course, and the pathname (e.g. 
[SRI-ARC]<NLS>PCP.TXT) to the latter, accessible via FTP using 
USER=ANONYMOUS and PASSWORD=GUEST (no account required). Let it be 
emphasised that files indicated by pathname of the form 
[SRI-ARC]<NLS>name.TXT are ASCII text files not NLS files. 


The specifications are contained in the following documents: 
HOST (24581,) "NSW Host Protocol" 


This document describes the host level protocol used in the NSW. 
The protocol is a slightly constrained version of the standard 
ARPANET host to host protocol. The constraints affect the 
allocation, RFNM wait, and retransmission policies. 
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Pathname: [SRI-ARC]<NLS>HOST.TXT 
PCP (24459,) "The Procedure Call Protocol" 
This document describes the virtual programming environment 
provided by PCP, and the inter-process exchanges that implement 
it. 
Pathname: [SRI-ARC]<NLS>PCP.TXT 
PIP (24460,) "The Procedure Interface Package" 
This document describes a package that runs in the setting 
provided by PCP and that serves as a procedure-call-level 
interface to PCP proper. It includes procedures for calling, 
resuming, interrupting, and aborting remote procedures. 
Pathname: [SRI-ARC]<NLS>PIP.TXT 
PSP (24461,) "The PCP Support Package" 
This document describes a package that runs in the setting 
provided by PCP and that augments PCP proper, largely in the 
area of data store manipulation. It includes procedures for 
obtaining access to groups of remote procedures and data stores, 
manipulating remote data stores, and creating temporary ones. 
Pathname: [SRI-ARC]<NLS>PSP.TXT 
PMP (24462, ) "The Process Management Package" 
This document describes a package that runs in the setting 
provided by PCP and that provides the necessary tools for 
interconnecting two or more processes to form a multi-process 
system (e.g. NSW). It includes procedures for creating, 
deleting, logically and physically interconnecting processes, 
and for allocating and releasing processors. 
Pathname: [SRI-ARC]<NLS>PMP.TXT 
PCPFMT (24576, ) "PCP Data Structure Formats" 


This document defines formats for PCP data structures, each of 
which is appropriate for one or more physical channel types. 


Pathname: [SRI-ARC]<NLS>PCPFMT.TXT 
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PCPHST (24577,) "PCP ARPANET Inter-Host IPC Implementation" 


This document defines an implementation, appropriate for 
mediating communication between Tenex forks, of the IPC 
primitives required by PCP. 


Pathname: [SRI-ARC]<NLS>PCPHST.TXT 
PCPFRK (24578,) "PCP Tenex Inter-Fork IPC Implementation" 


This document defines an implementation, appropriate for 
mediating communication between processes on different hosts 
within the ARPANET, of the IPC primitives required by PCP. 


Pathname: [SRI-ARC]<NLS>PCPFRK.TXT 
EXEC (24580,) "The Executive Package" 


This document describes a package that runs in the setting 
provided by PCP. It includes procedures and data stores for 
user identification, accounting, and usage information. 


Pathname: [SRI-ARC]<NLS>EXEC.TXT 
FILE (24582,) "The File Package" 


This document describes a package that runs in the setting 
provided by PCP. It includes procedures and data stores for 
opening, closing, and listing directories, for creating, 
deleting, and renaming files, and for transfering files and file 
elements between processes. 


Pathname: [SRI-ARC]<NLS>FILE.TXT 
BATCH (24583,) "The Batch Job Package" 


This document describes a package that runs in the setting 
provided by PCP. It includes procedures for creating and 
deleting batch jobs, obtaining the status of a batch job, and 
communicating with the operator of a batch processing host. This 
package is implemented at the host that provides the batch 
processing facility. 


Pathname: [SRI-ARC]<NLS>BATCH.TXT 


RJE-MODEL (24655,) "The NSW Remote Job Entry Model" 
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This document discusses the process of utilizing a batch 
processing facility to complete a programming task in the NSW 
environment. This same activity in another environment might 
utilize a remote job entry system. 


Pathname: [SRI-ARC]<NLS>RJE-MODEL.TXT 
LLDBUG (24579,) "The Low-Level Debug Package" 


This document describes a package that runs in the setting 
provided by PCP. It includes procedures for a remote process to 
debug at the assembly-language level, any process known to the 
local process. The package contains procedures for manipulating 
and searching the process” address space, for manipulating and 
searching its symbol tables, and for setting and removing 
breakpoints from its address space. Its data stores hold 
process characteristics and state information, and the contents 
of program symbol tables. 


Pathname: [SRI-ARC]<NLS>LLDBUG.TXT 
TBH (24656,) "NSW Requirments on Tool Bearing Hosts" 


This document discusses the environment needed in the tool 
bearing host and the interfaces to the operating system 
components by various PCP packages. 


Pathname: [SRI-ARC]<NLS>TBH.TXT 
BOXES (24584,) "Black Boxes in PCP" 


This document describes the transliteration of the black boxes 
defined by Millstein and Warshall into the setting provided by 
PCP, especially the File Package and the Executive Package. 


Pathname: [SRI-ARC]<NLS>BOXES.TXT 


The document on the Host level protocol, HOST, is a suggestion for 
some restrictions on the regular ARPANET host protocol for use in NSW, 
this topic has little impact on the remainder of the NSW protocols. 
The reader is urged to begin with the major Procedure Call Protocol 
documents. 


The document on PCP is the place the interested reader should start. 
It gives the required motivation for the Protocol and states the 
substance of the Protocol proper. 
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The reader may then proceed to the next three documents: PIP, PSP and 
PMP. The latter has the most relavence to the casual reader; the 
programmer faced with coding in the PCP environment should read all 
three. 


The three documents PCPFMT, PCPHST, and PCPFRK specify low level 
details of the communication formats and are of interest only to PCP 
implementers. 


The documents EXEC, FILE and BATCH describe procedure packages to be 
implemented as appropriate to provide the services of the 
accounting/status/usage statistics subsystem, the file subsystem or 
batch processing subsystem respectively. 


The document RJE-MODEL describes how a user would utilize various 
tools in the NSW in the process of carrying out tasks he might in the 
absence of NSW achieve using a remote job entry system. This should be 
read with the document on BATCH. 


The LLDBUG package specifies a debugging package that operates in the 
PCP environment. 


The document called BOXES describes a mapping between the PCP 
mechanisms and the File Package procedures and the Black Boxes needed 
by the Works Manager. 


The document TBH speaks to the requirements placed on the Tool Bearing 
Host. This document indicates how and where various PCP packages 
interface to an operating system. 
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